![NPM total downloads](https://img.shields.io/npm/dt/fast-xml-parser.svg)
Validate XML, Parse XML to JS Object, or Build XML from JS Object without C/C++ based libraries and no callback.
XML Parser v5 is added for experimental use
https://solothought.com
Sponsor this project 👉
![Stubmatic donate button](https://github.com/NaturalIntelligence/fast-xml-parser/raw/HEAD/static/img/support_paypal.svg)
Check the complete list at ThankYouBackers for our sponsors and supporters.
Through Github
![](https://avatars.githubusercontent.com/u/1396951?s=60)
Through OpenCollective
![](https://opencollective.com/fast-xml-parser/sponsor/9/avatar.svg)
Users
![](https://avatars.githubusercontent.com/u/20269980?v=4)
Check the bigger list
The list of users is collected either from the list published by Github, communicated directly through mails/chat , or from other resources. If you feel that your name in the above list is incorrectly published or you're not the user of this library anymore then you can inform us to remove it. We'll do the necessary changes ASAP.
If you want to be an anonymous user of this application and don't want to be highlighted anywhere then you can contact me at
Main Features
- Validate XML data syntactically
- Parse XML to JS Object
- Build XML from JS Object
- Works with node packages, in browser, and in CLI (press try me button above for demo)
- Faster than any other pure JS implementation.
- It can handle big files (tested up to 100mb).
- Controlled parsing using various options
- XML Entities, HTML entities, and DOCTYPE entites are supported.
- unpaired tags (Eg
<br>
in HTML), stop nodes (Eg <script>
in HTML) are supported. - You can restore almost same XML from JSON
- Supports comments
- It can preserve Order of tags in JS object
- You can control if a single tag should be parsed into array.
- Supports parsing of PI (Processing Instruction) tags with XML declaration tags
- And many more other features.
v5
I developed v5 in Apr 2023. And I didn't get the chance to complete all the features. I've ensured that new features don't impact performance. With v5, you have more control on parsing output. Check docs for syntax help and basic understanding.
Please leave a comment in discussion forum for your suggestions and if you really need v5.
How to use
To use as package dependency
$ npm install fast-xml-parser
or
$ yarn add fast-xml-parser
To use as system command
$ npm install fast-xml-parser -g
To use it on a webpage include it from a CDN
Example
As CLI command
$ fxparser some.xml
In a node js project
const { XMLParser, XMLBuilder, XMLValidator} = require("fast-xml-parser");
const parser = new XMLParser();
let jObj = parser.parse(XMLdata);
const builder = new XMLBuilder();
const xmlContent = builder.build(jObj);
In a HTML page
<script src="path/to/fxp.min.js"></script>
:
<script>
const parser = new fxparser.XMLParser();
parser.parse(xmlContent);
</script>
Check lib folder for different browser bundles
Bundle Name | Size |
---|
fxbuilder.min.js | 5.2K |
fxparser.js | 50K |
fxparser.min.js | 17K |
fxp.min.js | 22K |
fxvalidator.min.js | 5.7K |
Documents
v3
v4
- GettingStarted.md
- XML Parser
- XML Builder
- XML Validator
- Entities
- HTML Document Parsing
- PI Tag processing
Performance
XML Parser
![](https://github.com/NaturalIntelligence/fast-xml-parser/raw/HEAD/./docs/imgs/XMLParser_v4.png)
- Y-axis: requests per second
- X-axis: File size
Large files
![](https://github.com/NaturalIntelligence/fast-xml-parser/raw/HEAD/./docs/imgs/XMLParser_large_v4.png)
- Y-axis: requests per second
- X-axis: File size
XML Builder
![](https://github.com/NaturalIntelligence/fast-xml-parser/raw/HEAD/./docs/imgs/XMLBuilder_v4.png)
- Y-axis: requests per second
negative means error
![](https://github.com/NaturalIntelligence/fast-xml-parser/raw/HEAD/static/img/ni_ads_ads.gif)
Supporters
Contributors
This project exists thanks to all the people who contribute. [Contribute].
![](https://opencollective.com/fast-xml-parser/contributors.svg?width=890&button=false)
Backers
Thank you to all our backers! 🙏 [Become a backer]
![](https://opencollective.com/fast-xml-parser/backers.svg?width=890)
License
![Donate $5](https://github.com/NaturalIntelligence/fast-xml-parser/raw/HEAD/static/img/donation_quote.png)